package com.atguigu.tingshu.account.service;

import com.atguigu.tingshu.model.account.UserAccount;
import com.atguigu.tingshu.model.account.UserAccountDetail;
import com.atguigu.tingshu.vo.account.AccountDeductVo;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;

import java.math.BigDecimal;

public interface UserAccountService extends IService<UserAccount> {

    /**
     * 初始化用户账户记录
     *
     * @param userId 用户ID
     */
    void saveUserAccount(Long userId);

    /**
     * 保存账户变动日志
     *
     * @param userId    用户ID
     * @param title     资金变动缘由
     * @param tradeType 交易类型
     * @param amount    变动金额
     * @param orderNo   订单编号
     */
    void saveUserAccountDetail(Long userId, String title, String tradeType, BigDecimal amount, String orderNo);

    /**
     * 获取用户账户可用余额
     *
     * @param userId 用户ID
     * @return 可用余额
     */
    Double getAvailableAmountByUserId(Long userId);

    /**
     * 检查及扣减账户余额
     *
     * @param accountDeductVo 账户扣除参数
     */
    void checkAndDeduct(AccountDeductVo accountDeductVo);

    /**
     * 在支付成功后更新账户
     *
     * @param orderNo 订单号
     */
    void updateAccountOnPaySuccess(String orderNo);

    /**
     * 分页查询指定用户的账户明细记录
     *
     * @param page   分页参数
     * @param userId 用户ID
     * @param tradeType 交易类型：1201-充值 1202-锁定 1203-解锁
     * @return 账户明细记录分页对象
     */
    Page<UserAccountDetail> getUserAccountDetailPage(Page<UserAccountDetail> page, Long userId, String tradeType);
}
